NeXtLeveL Music Player - Complete User Guide
?? QUICK START
Launch the Player: While in-game, press Shift + F7 to open/close the music player.

Add Music: Place your MP3/WAV files in:
GTA V\scripts\NeXtLeveLMusicPlayer\Music\
(You can organize them in subfolders)

Basic Controls:

Enter/NumPad 5: Select/Menu Confirm

Arrow Keys: Navigate menus

Backspace: Go back/Close player

Space: Play/Pause music

?? MAIN MENU OPTIONS
1. Now Playing
View current track info, progress bar, and playback status

Controls:

Left Arrow: Previous track

Right Arrow: Next track

Enter/Space: Play/Pause

Down Arrow: Go to Library

Up Arrow: Go to Settings

2. Aurora Visualizer
Real-time music visualization with animated bars, waves, and effects

Controls: Same as Now Playing screen

Features color-changing bars that react to different frequency ranges

3. Library
Four ways to browse your music:

Folders
Browse by folder structure as organized in your Music directory

A-Z Keys: Jump to folders starting with that letter

Page Up/Down: Scroll faster

Home/End: Jump to top/bottom

All Songs
View every track in alphabetical order

+ Key: Add track to playlist (when viewing tracks)

Recently Added
Shows newest tracks (up to 300 most recent)

Refresh Library
Update the library after adding new music files

4. Playlists
Create and manage custom playlists:

Create New Playlist
Type a name using keyboard

Enter: Create playlist

Backspace: Cancel

My Playlists
View all created playlists

Enter: Open playlist tracks

Delete/Subtract Key: Delete selected playlist

Shows track count for each playlist

Adding Tracks to Playlists:
Navigate to any track list (All Songs, Folders, etc.)

Press + (Plus Key) while highlighting a track

Select a playlist from the picker

Press Enter to add

5. Settings
Customize your experience:

Playback Mode:
Normal: Plays through queue once

Loop All: Continuously loops entire queue

Loop One: Repeats current track indefinitely

Shuffle:
Toggle random playback on/off

Sort Mode:
A ? Z: Alphabetical ascending

Z ? A: Alphabetical descending

Newest: Most recent files first

Oldest: Oldest files first

Volume:
Adjust playback volume (0-100%)

Brightness:
Adjust screen brightness (30-100%)

Theme Colors:
Background: Device background color (24 dark presets)

Text: Menu text color (24 vibrant presets)

Accent: Highlight/button color (24 rich presets)

Use Left/Right arrows to cycle through color presets

Save Settings:
Save all current settings and playback position

Reset Defaults:
Restore all settings to factory defaults

6. About
View information about the player

Shows music directory path and supported formats

7. Close
Close the music player UI (music continues playing)

?? ADVANCED CONTROLS
Navigation Shortcuts:
A-Z Keys: Jump to items starting with that letter (in lists)

Page Up/Left: Jump up 12 items

Page Down/Right: Jump down 12 items

Home: Jump to first item

End: Jump to last item

Playback Controls:
Shift + F7: Toggle player on/off anytime

Previous Track: Left Arrow (or press when <3s into track to restart)

Next Track: Right Arrow

Add to Playlist: Plus (+) key on any track

Delete Playlist: Delete/Subtract key in playlist list

Visualizer Features:
32 dynamic bars reacting to 7 frequency ranges

5 static orbs at bottom pulsing to different frequencies

Energy rings spawn on beats

Aurora wave effect at top

Beat-synced color changes

?? DATA & SETTINGS
Auto-Save Features:
Playback position saved every 15 seconds

Settings automatically saved when changed

Playlist changes saved immediately

Last playback state restored when reopening game

File Locations:
Music: scripts\NeXtLeveLMusicPlayer\Music\

Settings: scripts\NeXtLeveLMusicPlayer\NeXtLeveLMusicPlayer.ini

Playlists: scripts\NeXtLeveLMusicPlayer\Playlists\*.txt

Supported Formats:
MP3 files (.mp3)

WAV files (.wav)

?? THEME CUSTOMIZATION
Color Presets (24 each):
Backgrounds: Deep Space, Midnight Purple, Abyss Blue, etc.

Text: Bright Cyan, Hot Pink, Light Lime, etc.

Accents: Steel Blue, Brick Red, Sage Green, etc.

Brightness Control:
Adjusts screen overlay darkness

Lower for darker UI, higher for brighter

?? TROUBLESHOOTING
No Music Found:
Ensure files are in: scripts\NeXtLeveLMusicPlayer\Music\

Files must be .mp3 or .wav format

Press Refresh Library in Library menu

Playback Issues:
Some MP3 files may have encoding issues

Try converting problem files to different MP3 format

WAV files generally have best compatibility

Player Not Opening:
Ensure script is properly installed

Check for conflicts with other mods

Try different key if F7 is bound elsewhere

Visualizer Not Working:
Only active when music is playing

Requires FFT analysis support

May not work with certain audio files

?? QUICK REFERENCE CARD
Open/Close: Shift + F7
Select: Enter/NumPad 5
Back: Backspace
Play/Pause: Space/Enter (in Now Playing)
Next Track: Right Arrow
Previous Track: Left Arrow
Jump in Lists: A-Z keys
Fast Scroll: Page Up/Down
Add to Playlist: + (Plus key)
Delete Playlist: Delete key

Menu Path: Home ? Library ? [Browse] ? Select Track ? Now Playing

?? PRO TIPS
Organize with Folders: Use subfolders in Music directory for genres, artists, etc.

Quick Play: From any track list, just press Enter on a track to start playing

Queue Management: The player remembers your last playback queue

Theme Matching: Try matching accent color to your favorite in-game vehicle

Visualizer Enjoyment: Best experienced in first-person view while stationary

Playlist Building: Add tracks from any location (Folders, All Songs, Recently Added)